home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / chukaluk.zip / CHUKALUK.DOC < prev    next >
Text File  |  1993-04-20  |  16KB  |  405 lines
  1.  
  2.                       * * *  CHUCK-A-LUCK  * * *
  3.                      Copyright 1993 by M & S Software
  4.  
  5. Chuck-A-Luck Version .06 beta
  6. 04/18/1993 by M & S Software
  7.  
  8. Author: Mike Jordan    
  9.               
  10. Built in BBS Support For: 
  11.  
  12.   Wildcat! BBS 3.X, 2.X, 1.13       PCBoard BBS 14.X           QuickBBS
  13.   Remote Access                     Spitfire BBS               GAP BBS
  14.   RBBS-PC BBS                       T.A.G. BBS
  15.  
  16.  
  17. *** Game Discription ***
  18.  
  19. Chuck-A-Luck is a Las Vegas style betting game where you bet on the
  20. roll of 3 dice in hopes of making a bundle.  Be warned thou...the
  21. House _does_ have the advantage. <grin>
  22.  
  23. Chuck-A-Luck does not require a Demo Key nor does it expire.  It has 
  24. no annoying beeps, whistles, slow downs or other devices to get you 
  25. to register.  The registered version does have a few features not 
  26. found in the non-registered version though. Non-registered only works
  27. in single node mode, scores are reset after 21 days and bulletins are 
  28. not created.  In addition the makeup and play-ahead feature is not 
  29. available.
  30.  
  31. *** Warranty ***
  32.  
  33. This product is provided "as is" without warranty of any kind. The entire
  34. risk as to the results and performance of the program is assumed by you.
  35. Furthermore, the author does not warrant, guarantee, or make any representa-
  36. tions regarding the use of, or the results of the use of the program, and you
  37. rely on the program and results solely at your own risk. The author cannot
  38. accept responsibility for system damage, loss of profit, or any other special,
  39. incidental, or consequential damages resulting from the use of or inability to
  40. use this product.  
  41.  
  42. *** Licensing ***
  43.     
  44. Upon registering you are granted a licensed Chuck-A-Luck.KEY, which gives you
  45. certain limited rights to use Chuck-A-Luck.
  46.  
  47. You are granted the use of Chuck-A-Luck on a single BBS System. 
  48. It may be used on several CPUs in a Networking or Multi-Tasking environment 
  49. where the BBS System has more than one physically connected node (i.e. 
  50. LAN Network).
  51.  
  52. You do not become an owner of Chuck-A-Luck.  M & S Software retains 
  53. all rights to the software, copies of the software and related 
  54. materials. Also upon registering, you agree to use reasonable efforts to 
  55. protect the registered CHUCK-A-LUCK.KEY file from unauthorized use, reproduction 
  56. and distribution.  All rights not specifically granted in this license are
  57. reserved by M & S Software.
  58.                                                          
  59. Failure to comply with this License can result in termination of the
  60. License without refund.
  61.  
  62.  
  63. *** Shareware Version ***
  64.  
  65. This door game is distributed under the SHAREWARE concept.  This means
  66. that you may use the SHAREWARE (unregistered evaluation version)
  67. version for a reasonable period of time, which is normally thirty to sixty 
  68. days.  After this period you must either register your copy or discontinue 
  69. usage.  
  70.  
  71. *** Three Ways To Run Chuck-A-Luck ***
  72.  
  73. 1.  Running Locally:
  74.   
  75. To run locally you must first create a CHUKALUK.CFG file.  To create this 
  76. file run CL_SETUP.COM and fill in the fields that are presented.  The .CFG file
  77. can also be created or edited with any ASCII editor.  See the example 
  78. CHUKALUK.CFG file for the lines required.  You can also run the setup 
  79. program by typing CHUKALUK at the DOS prompt without any parameters.  This will
  80. bring up the setup program.
  81.  
  82. Then at the DOS prompt type:
  83.                          
  84.         CHUKALUK CHUKALUK.CFG LOCAL
  85.  
  86. By specifying the configuration file the game will use the Sysop's real
  87. name (the name that is entered in the *.CFG file) nstead of the name "Sysop".
  88. It will also use the other parameters in the CHUKALUK.CFG file that are 
  89. active with the non-registered version. If the registered CHUKALUK.KEY is
  90. present then all parameters will be active.
  91.  
  92. 2.  Running in Evaluation Mode:
  93.  
  94. Chuck-A-Luck does not need a Demo Key to run in evaluation mode.  Create a 
  95. CHUKALUK.CFG and setup as described later in this documentation and you are
  96. all set.  The evaluation mode will give you all the features of the 
  97. registered version EXCEPT that Bulletins will not be created, the multi-node
  98. option will not function and the dedication line will not be implemented. In
  99. addition the game will reset the score board every 21 days (the reset at the
  100. 1st of each month is normal) and continue as if it was the first of the month.
  101.  
  102. 3.  Running as a Registered Door:
  103.  
  104. You must have the Registration Key to run as a registered door. To register 
  105. simply print-out or copy the contents of the REGISTER.FRM file provided 
  106. in this package. Fill it out with the requested information and send it
  107. with check, money order or COD information to the address on the form itself
  108. or at the end of this documentation.  You may also send the information
  109. by Net Mail or upload it to my board for COD orders.
  110.  
  111. Upon receipt of your order you will be sent your registered key.  This
  112. will be done, via Net-Mail where applicable, upload to your BBS if 
  113. possible or by U.S. Mail.  All COD orders will be sent UPS or U.S. Mail. 
  114. ** Note: All COD fees will be added to the registration price.
  115.  
  116.  
  117. *** Playing The Game ***
  118.  
  119. Instructions on how to play this game can be found online by selecting [H]elp
  120. from the main menu or from within the game itself.
  121.  
  122.  
  123. *** Support ***
  124.  
  125. I will do my best to help with any problems encountered weither the game
  126. is registered or not. 
  127.  
  128. If you register this door, I will do my best to ensure that the registered
  129. key is sent promptly.  I will do the best I can to support this door and
  130. resolve any problems that might arise.  I can't guarantee to fix or resolve 
  131. all problems since there are so many different combinations of hardware, 
  132. software and system configurations being used but I will do my best.
  133.  
  134. Support can be obtained by calling my BBS, by mail or though the FIDO Network.
  135. My current Node addresses are 1:105/314, 1:105/317, 1:105/330.  I also 
  136. participate in the DOORWARE, On-Line-Games and DOORGAMES echos as well as the 
  137. MSI-WILDCAT echo and will answer any questions addressed to me. 
  138.  
  139. *** Features ***
  140.  
  141.         * Supports Wildcat 1.13, 2.X & 3.X, QuickBBS, PCBoard 14.X, Gap,
  142.           Spitfire, RBBS-PC, Remote Access and T.A.G. directly without the
  143.           use of converters (and any others that use the same type info files).
  144.  
  145.         * File Sharing & Record Locking for Networks & Multi-Tasking Systems.
  146.           (Feature requires Registered Key File.)
  147.  
  148.         * DESQview Detection & Awareness, which speeds program execution. 
  149.  
  150.         * Complete Setup Program to create the CHUKALUK.CFG file.
  151.  
  152.         * Full ANSI Game.
  153.  
  154.         * Full Spilt-Screen Chat.
  155.  
  156.         * Sysop can Add or Decrease Time allowed in door with function keys.
  157.  
  158.         * Sysop can force user back to BBS with function key.
  159.  
  160.         * Mono selected colors for sharp picture when played in Mono Mode.
  161.  
  162.         * Built in bulletin generator for ANSI and ASCII bulletins (registered
  163.           version only).
  164.  
  165.         * Selectable In-depth Log File capability.
  166.  
  167.         * Carrier Drop Detection.
  168.  
  169.         * No Input In 5 Minutes, Time Out Detection.
  170.  
  171.         * Full BBS and FIDO Support (Demo or Registered)
  172.  
  173.         * Supports Comm Ports 1, 2, 3 & 4 And Non-Standard IRQ selection.
  174.  
  175.         * Supports Locked DTE Rate from 300 to 115,200 Baud.
  176.  
  177.     * Supports FOSSIL detection
  178.  
  179. *** Files In Archive ***
  180.  
  181. The following files are found either in the BOOBYTRP.ZIP or will be
  182. created during the runtime execution.
  183.  
  184. CHUKALUK.EXE    <--- Executable Program.
  185.  
  186. CL_SETUP.COM    <--- Chuck-A-Luck Setup Program
  187.  
  188. CHUKALUK.CFG  * <--- Sample Configuration File.
  189.  
  190. CHUKALUK.DAT  * <--- Store User's Name, Last Play Date & Scores.
  191.  
  192. CHUKALUK.HPS    <--- Ansi Mode Instructions Used By Program.
  193.  
  194. CHUKALUK.DOC    <--- This File.
  195.  
  196. CHUKALUK.SLB    <--- Screen Library.
  197.  
  198. CHUKALUK.CHP  * <--- Last Month's Champion File.
  199.  
  200. CHUKALUK.LOG  * <--- Game Activity Log.
  201.  
  202. DOOR.BAT        <--- Simple Sample Batch File For Door Execution.
  203.  
  204. REGISTER.FRM    <--- Registration Form For This And Other Doors.
  205.  
  206. HISTORY.TXT     <--- History file listing changes.
  207.  
  208. UPGRADE.TXT     <--- Explains what is needed to upgrade to new release
  209.                      from previous one.
  210.  
  211. CHUKALUK.KEY    <--- Registration key. (Not needed for Evaluation mode)
  212.  
  213. SUPPORT.TXT     <--- List of boards carring the latest version.
  214.  
  215. FOSSIL.TXT      <--- Information on Fossil support
  216.  
  217. * DENOTES that file is created during RUN-TIME.
  218.  
  219. CHUKALUK.CHP:
  220.  
  221. This is the Last Month's Champion file. It contains the Champ's Name, Score,
  222. Date and How many games won that month. This file is automatically created
  223. when the game is first executed.
  224.  
  225. Deleting the CHUKALUK.CHP file will cause the game to re-initialize
  226. itself. It will create a new CHUKALUK.CHP file and a new CHUKALUK.DAT file.
  227.  
  228.  
  229. *** Setup & Installation ***
  230.  
  231. Installation procedures are very simple if you have setup a live program in
  232. the past. First create a Sub-Directory for the door game and copy all the
  233. files from the CHUKALUK.ZIP file into this directory.
  234.  
  235. Now execute the Setup program CL_SETUP.COM by either typing CHUKALUCK with
  236. no parameters at the DOS prompt or executing the CL_SETUP.COM program
  237. itself. 
  238.  
  239. This will run the game's setup feature that will create a CHUKALUK.CFG
  240. file. The setup program has complete on-line help so I will not duplicate
  241. it here.
  242.  
  243. This is what the CHUKALUK.CFG contains when created (less the comments).
  244.  
  245.    1                        <-- COM PORT 1, 2, 3, 4 or &H###/#
  246.    N                        <-- Multi-Node 'Y' or 'N' 
  247.    COM-DAT BBS              <-- Name Of BBS
  248.    Mike Jordan              <-- Sysop's Full Name
  249.    DOOR.SYS                 <-- BBS Callers File
  250.    C:\WC30\WCWORK\NODE1\    <-- Drive & Path Of System's Caller File 
  251.    LOG                      <-- LOG to keep user log or NOLOG to disable
  252.    C:\BULLETIN\BULL99.BBS   <-- Drive\Path\BulletinName For Ansi Scores
  253.    C:\BULLETIN\BULL99.SCR   <-- Drive\Path\BulletinName For Ascii Scores
  254.    Wildcat                  <-- Type of BBS System You're Running See Note 1
  255.    Thanks For The Donations <-- 50 character dedication line
  256.    Please Help Register     <-- 55 character "Nag" line.
  257.    50                       <-- Dice Rolls Allowed Per Day (1 to 99)
  258.    5                        <-- Number of Days allowed for Makeup 
  259.    1                        <-- Day that Makeup Games Start 
  260.                                 (31 deactivates Makeup)
  261.  
  262. NOTE 1: Valid System Callers files for each BBS system are as follows:
  263.  
  264.             Wildcat 3.X BBS System         <->  USERINFO.DAT or DOORS.SYS
  265.             Wildcat! 1.X & 2.X BBS System  <->  CALLINFO.BBS
  266.             QuickBBS System                <->  DORINFOx.DEF
  267.             RBBS-PC BBS System             <->  DORINFOx.DEF
  268.             Remote Access BBS System       <->  DORINFOx.DEF
  269.             T.A.G. BBS System              <->  DORINFOx.DEF
  270.             PCBoard BBS System             <->  DOOR.SYS
  271.             Gap BBS System                 <->  DOORS.SYS
  272.             Spitfire BBS System            <->  SFDOORS.DAT
  273.  
  274. If you use another BBS System besides those listed, then you must use
  275. a converter to convert to one of the above caller file formats.
  276.  
  277. ** The Bulletin Drive\Path\Bulletin Name is designed to accept any valid
  278. Drive, Path and Filename of your choice. This allows each BBS system to
  279. configure for its individual system.
  280.  
  281. Note 3: Lines 11 and 12 (the dedication and Nag line) are required, even
  282. if they are left blank.
  283.  
  284. *** Execution ***
  285.  
  286. Some BBS Systems call batch files and some run doors directly. If you
  287. don't know how to install a door on your particular BBS System then please
  288. see your BBS manual. This game merely needs the .CFG file name passed to it on
  289. the command line to operate, i.e. 
  290.  
  291.           CHUKALUK.EXE CHUKALUK.CFG
  292.  
  293. An example CHUKALUK.BAT file could look like this:
  294.  
  295.      C:                         <-- Change to drive door is in
  296.      CD \CHUKALUK               <-- Change to door directory
  297.      CHUKALUK.EXE CHUKALUK.CFG  <-- Execute door with config file
  298.      CD\BBS                     <-- Change back to BBS (may not be needed)
  299.      
  300.  
  301. *** Multi-Node Use ***
  302.    
  303. Running this game on more than a single node requires a Multi-Node Key.
  304. When running in Evaluation mode, only one (1) Node will be able to access the
  305. door at a time. You may use different configuration file names for each node 
  306. when running in Multi-Node.
  307.  
  308. Use the SETUP program to create the configuration file and then rename
  309. it for each node. For a short cut, you may create one file and copy
  310. it to the different names and edit the file with any text editor. Just
  311. be sure to keep all fields correct.  
  312.  
  313. **Make sure the PORT number is correct for each node.**
  314.  
  315. Example Of File Naming and execution:
  316.  
  317.         Node 1: CHUKALUK CHUKALUK.CF1
  318.         Node 2: CHUKALUK CHUKALUK.CF2
  319.         Node 3: CHUKALUK CHUKALUK.CF3
  320.  
  321.  
  322. *** Notes Of Interest ***
  323.  
  324. This game does not require a monitoring program for dropped carrier as
  325. it automatically detects this and exits back to the BBS.
  326.  
  327. This door DOES NOT require any runtime modules. It will run
  328. as is without aid from outside utilities.
  329.  
  330.  
  331. *** Technical Support ***
  332.  
  333. If you have problems with this door game you can contact me through
  334. my BBS at the numbers listed below, or though my FIDO addresses 1:105/314,
  335. 1:105/317 or 1:105/330. 
  336.  
  337. BBS Phone:       Com-Dat
  338.          Node 1 - (503) 681-0543 (14.4 HST DS) 
  339.          Node 2 - (503) 640-0278 (14.4 v.32)
  340.          FIDO 1:105/314 (14.4 HST DS)
  341.                  FIDO 1:105/317 (14.4 V.32) 
  342.          24 hour - First time callers have access to
  343.                  door programs.
  344.  
  345.    or    :       Com-Dat II  (CM Mail Only - No Human callers)
  346.          Net Mail and File Requests of latest version
  347.          FIDO 1:105/330 - V.32 14.4
  348.  
  349. Mailing Address: Mike Jordan 
  350.                  2001 NE Hyde St.
  351.                  Hillsboro, OR.  97124
  352.  
  353.  
  354. *** Ordering Information ***
  355.  
  356. Please see the file REGISTER.FRM file in this package for ordering
  357. information.
  358.  
  359. *** Updates To M & S Doors ***
  360.  
  361. Updates to any M & S Software product may be downloaded from any Distribution
  362. BBS.  My intent is to always supply updates FREE unless major revisions are 
  363. made to the software, in which case a small update fee will be charged.
  364.  
  365. *** Distribution ***
  366.  
  367. You are free, in fact encouraged, to distribute the SHAREWARE version
  368. of the door game provided that all files contained in the original
  369. archive are distributed in their original unmodified state.
  370.  
  371. The Registered Key MAY NOT be distributed in any form.
  372.  
  373.  
  374. *** Acknowledgements ***
  375.  
  376.               Wildcat BBS System - Mustang Software
  377.               GAP Communications - The GAP Development Company
  378.               PCBoard - Clark Development Company, Inc.
  379.               Spitfire - Mike Woltz, Buffalo Creek Software
  380.               QuickBBS - The QuickBBS Group, Inc
  381.               Remote Access - Continental Software
  382.  
  383. *** Special Acknowledgement ***
  384.  
  385. I would like to give a very big thank you to the person that has done the
  386. most to make this game (plus all my past and hopefully future door games)
  387. possible.  This person is Rusty Johnson of JNS Software. Rusty has released
  388. many excellent door games into the BBS arena and you will probably see a lot of
  389. similarities in my games and his.  This is because Rusty has provided me with
  390. much of the code needed to make a door game work.  It's my code for the game,
  391. but it's Rusty's code that provides the Comm routines, scoring, bulletins,
  392. setup and just about everything else required to make this a working door. 
  393. Rusty and I have known each other for several years now and have helped each
  394. other many times and this is one case where giving has been rewarded tenfold. 
  395. I'm glad to be able to call Rusty my friend.  Thanks Rusty.
  396.  
  397. If you have not played any of Rusty's games then you are missing out on some
  398. of the best games available for BBSing.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. CHUCK-A-LUCK Copyright 1993 by M & S Software